GlobalService

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.globalplatform
Interface GlobalService

All Superinterfaces:: javacard.framework.Shareable

public interface GlobalService
extends javacard.framework.Shareable
extends javacard.framework.Shareable

This defines the interface for requesting a Global Services Application to provide its actual service interface. The Global Services Application uses this interface to check the validity of the request presented by an on-card entity. Prior to using this interface, an Application is required to obtain a handle to the Global Services Application by invoking the GPSystem.getService() method.

Since:: export file version 1.1

Field Summary
`static byte`	`KEY_ACCESS_ANY` Key Access indicating key may be used by the Security Domain and any associated application (0x00).
`static byte`	`KEY_ACCESS_APPLICATION` Key Access indicating key may be used by any associated application but not by the Security Domain (0x02).
`static byte`	`KEY_ACCESS_SECURITY_DOMAIN` Key Access indicating key may be used by the Security Domain but not by any associated application (0x01).
`static byte`	`KEY_TYPE_3DES` Key type indicating Triple DES reserved for specific implementations (0x81).
`static byte`	`KEY_TYPE_3DES_CBC` Key type indicating Triple DES in CBC mode (0x82).
`static byte`	`KEY_TYPE_AES` Key type indicating AES (0x88).
`static byte`	`KEY_TYPE_DES` Key type indicating DES with ECB/CBC implicitly known (0x80).
`static byte`	`KEY_TYPE_DES_CBC` Key type indicating DES in CBC mode (0x84).
`static byte`	`KEY_TYPE_DES_ECB` Key type indicating DES in ECB mode (0x83).
`static byte`	`KEY_TYPE_EXTENDED` Key type indicating extended key format (0xFF).
`static byte`	`KEY_TYPE_HMAC_SHA1` Key type indicating HMAC SHA1, length of HMAC implicitly known (0x90).
`static byte`	`KEY_TYPE_HMAC_SHA1_160` Key type indicating HMAC SHA1, length of HMAC is 160 bits (0x91).
`static byte`	`KEY_TYPE_RSA_PRIVATE_CRT_DP1` Key type indicating RSA Private Key Chinese Remainder dp1 component (0xA7).
`static byte`	`KEY_TYPE_RSA_PRIVATE_CRT_DQ1` Key type indicating RSA Private Key Chinese Remainder dq1 component (0xA8).
`static byte`	`KEY_TYPE_RSA_PRIVATE_CRT_P` Key type indicating RSA Private Key Chinese Remainder p component (0xA4).
`static byte`	`KEY_TYPE_RSA_PRIVATE_CRT_PQ` Key type indicating RSA Private Key Chinese Remainder pq component (0xA6).
`static byte`	`KEY_TYPE_RSA_PRIVATE_CRT_Q` Key type indicating RSA Private Key Chinese Remainder q component (0xA5).
`static byte`	`KEY_TYPE_RSA_PRIVATE_EXPONENT` Key type indicating RSA Private exponent (0xA3).
`static byte`	`KEY_TYPE_RSA_PRIVATE_MODULUS` Key type indicating RSA Private Key modulus (0xA2).
`static byte`	`KEY_TYPE_RSA_PUBLIC_EXPONENT` Key type indicating RSA Public Key exponent (0xA0).
`static byte`	`KEY_TYPE_RSA_PUBLIC_MODULUS` Key type indicating RSA Public Key modulus (0xA1).
`static byte`	`KEY_USAGE_COMPUTATION_DECIPHERMENT` Key usage indicating computation and decipherment (0x40).
`static byte`	`KEY_USAGE_CONFIDENTIALITY` Key usage indicating sensitive data confidentiality (0x08).
`static byte`	`KEY_USAGE_CRYPTOGRAPHIC_AUTHORIZATION` Key usage indicating cryptographic authorization (0x01).
`static byte`	`KEY_USAGE_CRYPTOGRAPHIC_CHECKSUM` Key usage indicating cryptographic checksum e.g.
`static byte`	`KEY_USAGE_DIGITAL_SIGNATURE` Key usage indicating Digital Signature (0x02).
`static byte`	`KEY_USAGE_SM_COMMAND` Key usage indicating Secure Messaging in command data field (0x10).
`static byte`	`KEY_USAGE_SM_RESPONSE` Key usage indicating Secure Messaging in response data field (0x20).
`static byte`	`KEY_USAGE_VERIFICATION_ENCIPHERMENT` Key usage indicating verification and encipherment (0x80).

Method Summary
`javacard.framework.Shareable`	`getServiceInterface(GPRegistryEntry clientRegistryEntry, short sServiceName, byte[] baBuffer, short sOffset, short sLength)` This method returns a handle to the requested service interface of a Global Services Application.

Field Detail

KEY_ACCESS_ANY

static final byte KEY_ACCESS_ANY

Key Access indicating key may be used by the Security Domain and any associated application (0x00).

See Also:: Constant Field Values

KEY_ACCESS_SECURITY_DOMAIN

static final byte KEY_ACCESS_SECURITY_DOMAIN

Key Access indicating key may be used by the Security Domain but not by any associated application (0x01).

See Also:: Constant Field Values

KEY_ACCESS_APPLICATION

static final byte KEY_ACCESS_APPLICATION

Key Access indicating key may be used by any associated application but not by the Security Domain (0x02).

See Also:: Constant Field Values

KEY_TYPE_AES

static final byte KEY_TYPE_AES

Key type indicating AES (0x88).

See Also:: Constant Field Values

KEY_TYPE_3DES

static final byte KEY_TYPE_3DES

Key type indicating Triple DES reserved for specific implementations (0x81).

See Also:: Constant Field Values

KEY_TYPE_3DES_CBC

static final byte KEY_TYPE_3DES_CBC

Key type indicating Triple DES in CBC mode (0x82).

See Also:: Constant Field Values

KEY_TYPE_DES

static final byte KEY_TYPE_DES

Key type indicating DES with ECB/CBC implicitly known (0x80).

See Also:: Constant Field Values

KEY_TYPE_DES_CBC

static final byte KEY_TYPE_DES_CBC

Key type indicating DES in CBC mode (0x84).

See Also:: Constant Field Values

KEY_TYPE_DES_ECB

static final byte KEY_TYPE_DES_ECB

Key type indicating DES in ECB mode (0x83).

See Also:: Constant Field Values

KEY_TYPE_EXTENDED

static final byte KEY_TYPE_EXTENDED

Key type indicating extended key format (0xFF).

See Also:: Constant Field Values

KEY_TYPE_HMAC_SHA1

static final byte KEY_TYPE_HMAC_SHA1

Key type indicating HMAC SHA1, length of HMAC implicitly known (0x90).

See Also:: Constant Field Values

KEY_TYPE_HMAC_SHA1_160

static final byte KEY_TYPE_HMAC_SHA1_160

Key type indicating HMAC SHA1, length of HMAC is 160 bits (0x91).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_CRT_P

static final byte KEY_TYPE_RSA_PRIVATE_CRT_P

Key type indicating RSA Private Key Chinese Remainder p component (0xA4).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_CRT_Q

static final byte KEY_TYPE_RSA_PRIVATE_CRT_Q

Key type indicating RSA Private Key Chinese Remainder q component (0xA5).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_CRT_PQ

static final byte KEY_TYPE_RSA_PRIVATE_CRT_PQ

Key type indicating RSA Private Key Chinese Remainder pq component (0xA6).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_CRT_DP1

static final byte KEY_TYPE_RSA_PRIVATE_CRT_DP1

Key type indicating RSA Private Key Chinese Remainder dp1 component (0xA7).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_CRT_DQ1

static final byte KEY_TYPE_RSA_PRIVATE_CRT_DQ1

Key type indicating RSA Private Key Chinese Remainder dq1 component (0xA8).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_EXPONENT

static final byte KEY_TYPE_RSA_PRIVATE_EXPONENT

Key type indicating RSA Private exponent (0xA3).

See Also:: Constant Field Values

KEY_TYPE_RSA_PRIVATE_MODULUS

static final byte KEY_TYPE_RSA_PRIVATE_MODULUS

Key type indicating RSA Private Key modulus (0xA2).

See Also:: Constant Field Values

KEY_TYPE_RSA_PUBLIC_EXPONENT

static final byte KEY_TYPE_RSA_PUBLIC_EXPONENT

Key type indicating RSA Public Key exponent (0xA0).

See Also:: Constant Field Values

KEY_TYPE_RSA_PUBLIC_MODULUS

static final byte KEY_TYPE_RSA_PUBLIC_MODULUS

Key type indicating RSA Public Key modulus (0xA1).

See Also:: Constant Field Values

KEY_USAGE_COMPUTATION_DECIPHERMENT

static final byte KEY_USAGE_COMPUTATION_DECIPHERMENT

Key usage indicating computation and decipherment (0x40).

See Also:: Constant Field Values

KEY_USAGE_CONFIDENTIALITY

static final byte KEY_USAGE_CONFIDENTIALITY

Key usage indicating sensitive data confidentiality (0x08).

See Also:: Constant Field Values

KEY_USAGE_CRYPTOGRAPHIC_AUTHORIZATION

static final byte KEY_USAGE_CRYPTOGRAPHIC_AUTHORIZATION

Key usage indicating cryptographic authorization (0x01).

See Also:: Constant Field Values

KEY_USAGE_CRYPTOGRAPHIC_CHECKSUM

static final byte KEY_USAGE_CRYPTOGRAPHIC_CHECKSUM

Key usage indicating cryptographic checksum e.g. MAC (0x04).

See Also:: Constant Field Values

KEY_USAGE_DIGITAL_SIGNATURE

static final byte KEY_USAGE_DIGITAL_SIGNATURE

Key usage indicating Digital Signature (0x02).

See Also:: Constant Field Values

KEY_USAGE_SM_COMMAND

static final byte KEY_USAGE_SM_COMMAND

Key usage indicating Secure Messaging in command data field (0x10).

See Also:: Constant Field Values

KEY_USAGE_SM_RESPONSE

static final byte KEY_USAGE_SM_RESPONSE

Key usage indicating Secure Messaging in response data field (0x20).

See Also:: Constant Field Values

KEY_USAGE_VERIFICATION_ENCIPHERMENT

static final byte KEY_USAGE_VERIFICATION_ENCIPHERMENT

Key usage indicating verification and encipherment (0x80).

See Also:: Constant Field Values

Method Detail

getServiceInterface

javacard.framework.Shareable getServiceInterface(GPRegistryEntry clientRegistryEntry,
                                                 short sServiceName,
                                                 byte[] baBuffer,
                                                 short sOffset,
                                                 short sLength)
                                                 throws javacard.framework.ISOException

This method returns a handle to the requested service interface of a Global Services Application.

Note:

The Global Services Application verifies the validity of the request according to its own security policies for this sServiceName and based on the identity of the requesting on-card entity and its characteristics as registered in the clientRegistryEntry;
On a valid service request, the Global Service Application returns the reference of the Shareable Interface Object implementing the actual service: this Shareable Interface Object may either be this Global Service interface or another Java Card shareable interface;
Depending on its own security policy, the Global Service Application may reject an invalid service request by either throwing an exception or just returning null.

Parameters:: clientRegistryEntry - the GP Registry entry reference of the requesting on-card entity.; sServiceName - the requested service name.; baBuffer - the source byte array containing additional parameters of the service request.; sOffset - offset of the additional request parameters within the source byte array.; sLength - length of the additional request parameters.
Returns:: the specific service interface reference or null.
Throws:: javacard.framework.ISOException - with the following reason codes:
ISO7816.SW_CONDITIONS_NOT_SATISFIED
ISO7816.SW_SECURITY_STATUS_NOT_SATISFIED














  
      Package 
    Class 
      Tree 
      Deprecated 
      Index 
      Help 
  









 PREV CLASS 
 NEXT CLASS

  FRAMES   
 NO FRAMES   
 







  SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.globalplatform Interface GlobalService